scrolledwindow: update GtkPolicyType docs

The policy is not determining the visibility of the scrollbars anymore, but the
how the size is to be computed to achive the selected visibility.

diff --git a/gtk/gtkscrolledwindow.h b/gtk/gtkscrolledwindow.h
index 9ac60f83e74ba5bfcfffd6a4042846e3fad98000..d666f3a70a46a7a6181e38daafb5d55646a67c78 100644 (file)
--- a/gtk/gtkscrolledwindow.h
+++ b/gtk/gtkscrolledwindow.h
@@ -120,12 +120,15 @@ typedef enum
 
 /**
  * GtkPolicyType:
- * @GTK_POLICY_ALWAYS: The scrollbar is always visible.
- * @GTK_POLICY_AUTOMATIC: The scrollbar will appear and disappear as necessary. For example,
- *  when all of a #GtkTreeView can not be seen.
- * @GTK_POLICY_NEVER: The scrollbar will never appear.
+ * @GTK_POLICY_ALWAYS: The scrollbar is always visible. The view size is
+ *  independent of the content.
+ * @GTK_POLICY_AUTOMATIC: The scrollbar will appear and disappear as necessary.
+ *  For example, when all of a #GtkTreeView can not be seen.
+ * @GTK_POLICY_NEVER: The scrollbar should never appear. In this mode the
+ *  content determines the size.
  *
- * Determines when a scroll bar will be visible.
+ * Determines how the size should be computed to achieve the one of the
+ * visibility mode for the scrollbars.
  */
 typedef enum
 {